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PART 15 
CHAPTER 1 

INTRODUCTION TO FILDMP 

1.1 INTRODUCTION 

File Diomp (FILDMP) is a utility program for use with the PDP-11 Disk Operating 
System (DOS/BATCH) . It can be used to enhance the debugging of programs by prO' 
viding a printed copy of the contents of all or specific blocks of a file for 
visual inspection. 


Printout of a file or block (s) of data can be directed from an input device to any 
device capable of ASCII output. 

^LDMP takes its input either as filenames or mass storage block numbers, and out- 
puts a dump in various formats. The printed dump is in a readable format. FILDMP 
is device independent in that the output can be stored on disk or tape for later 
printing. 

FILDMP command strings are interpreted by the DOS/BATCH Command String Interpreter 
(CSI) , as explained in Chapter 3-6. For example, the general format of a FILDMP 
command string is: 


output file specification (s)<input file specification 


or 


outdev: filename . ext/ switch<indev: filename . ext/switch 

The output file specification on which the data is to appear is usually KB: (terminal) 
or LP: (line printer) , but can be a file on any mass storage device. The /switch 
represents FILDMP 's switch options. The input device, indev; , is the device on which 
the file IS stored, the DOS /BATCH system device is assumed if no input device is 
specified. Note that all keyboard command strings are terminated with the RETURN key, 
which is non- printing. 


There may be any number of output file specifications (or none, in which case no 
output is generated). However, there must be exactly one input file specification. 

The entire command string must not be more than 72 decimal characters, the length 
of a teleprinter line. 
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1.2 RUNNING FILDMP 


FILDMP is loaded as a DOS/BATCH system program (see the DOS/BATCH System Manager' 
Guide) . It can then be called into core and executed with the DOS/BATCH Monitor 
RUN command. For example: 

$RUN FILDMP 
FILDMP Vxxx 
# 

FILDMI» identifies itself and prints #, indicating its readiness to accept a user 
command string from the teleprinter keyboard. 



PARTIS 
CHAPTER 2 
SWITCHES 

are controlled with switches in the cominand string. Switches 
are expressed using a slash and two letters, as shown below. There are two types 
of switches: input and output. 

2.1 input switches 

Input switches are used to: 


1. Specify the format in which data is to be read. 

2. Determine the mass storage block nxmbers on which a file is stored. 

3. Specify the block or group of blocks to be dumped. 

Input switches can appear only in the input field of the command string, i.e., to 
the right of the < symbol. They are: 

read specified blocks of mass storage. /BL requires at least 
one value (block nximber) , and will accept at most two values. 
The syntax for the /BL switch is: 

/BL:n or /BL:n:m 

where n and m are octal block numbers. 

causes FILDMP to obtain the numbers of the blocks which are 
allocated to the specified file. The input device must be a 
directory-structured device. 

read the input file in formatted ASCII mode. 

read the input file in formatted binary mode. 

FILDMP can read data in any of three modes: 


/BL 

/CH 

/FA 

/FB 


Unformatted binary 
Formatted binary 
Formatted ASCII 


default mode 

/FB 

/FA 


When no input switch is specified, data is read in' unformatted binary mode. Unfor 
matted binary mode is assumed with the /BL switch 
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Only one type of input switch can appear in a command string. For example: 
DT: FILE. EXT/FA 

is legal, but 

DT : FILE . EXT/FA/FB 

is not. 

The /BL switch can appear more than once in a command string. For example: 
DT : /BL : 1/BL : 7 : 1 3/BL : 2 2 


is legal, but 


DT:/BL: 23/FA 

is not because only one type of input switch can appear in a command string. In 
the last example, block 23 will Tbe dumped as directed followed by an error message 
when /FA is encountered. 

2.2 OUTPUT SWITCHES 

Output switches are used to specify the format in which the data is to be dumped. 
They should appear only in th€j output field of the command string, i.e., to the 
left of the < symbol. They ai:e: 


/AS read successive bytes of the input file or mass storage block 

and output each byte as if it were a single ASCII character. 

The ASCII character set which FILDMP considers printable is 
(octal) 40 through 137 and 240 through 337. Any value outside 
these ranges is printed as if it were 137 , a special printing 
character; for example, a left arrow or a heart-shaped character 

/by output the input file or mass storage block (s) as a sequence 

of octal bytes. 

/OC output the input file or mass storage block (s) as a sequence 

of octal words. 

/RA read successive words of the input file or mass storage block (s) 

consider each vrard as a three-character, packed Radix-50 entity, 
and unpack and output it as such. 

When no output switch is specified, the /OC switch is assumed. 
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Output switches can be used to direct FILDMP to perform certain modes of translation, 
e.g., a binary file can be dumped in ASCII. However, the /CH switch overrides any 
output switch and causes output to appear in octal words. 

output file specifications are allowed and, in fact, are common. For 
example, to dump FILE. EXT (a file written in formatted ASCII mode) in octal words 
and ASCII characters, use the following command string: 

LP : /OC , LP : /AS<FILE . EXT/FA 

where the line printer is the output device and FILE. EXT is on the system disk. In' 
the above example, FILE. EXT is read in formatted ASCII mode and dumped in octal 
words, and then read in formatted ASCII mode and dumped as ASCII characters. If, 
for example, FILE. EXT were on paper tape, it would be necessary to reload the paper 
tape prior to generating the second output. The command string would be: 

LP : /OC , LP : /AS<PR : /FA 

The command string: 

LP ; /BY , KB : /RA<DF : /BL : 3/BL : 17 : 21 

\ 

directs FILDMP to dump disk (DF:) blocks 3, 17, 20, and 21 on the line printer in 
octal byte format, and then on the teleprinter in unpacked Radix-50 format, 

2.3 OUTPUT FORMATS 

The output or printed format of the dump differs slightly, depending on the switch 
used. If no input switch (implied unformatted binary mode) or the /BL switch is 
specified, the leftmost column of the output is the byte count of the file or mass 
storage block. If the /FA or /FB switch is specified, the leftmost column of the 
output is the line nvimber of the file. The physical output line which begins with 
the line number contains the status and mode bytes and the byte count word as well. 

Read errors are indicated by an E between the line number and the status byte. The 
status byte gives detailed information concerning the error. The E error message 
appears only on dumps where the input is read in a formatted mode. 

If /CH appears in the input field, the output is the block numbers, in sequential 
order, occupied by the file. No byte count or line count appears. 
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The output of FILDMP contains a form of identifier. If /BL appears, FILDMP prints 
the device name and block niamber (in octal) prior to dumping any given block. Other 
wise, the input filename and extension, as specified in the command input, will 
appear, followed by; 


(ASCII) 

(BYTES) 

(CHAIN) 

(OCTAL) 

(RAD50) 


if the /AS switch is used. 

if the /BY switch is used. 

if the /CH switch is used. 

if the /OC switch is used or assumed. 

if the /RA switch is used. 


If the input file were read as a file (i.e., /FA, /FB, or no switch), FILDMP 
terminates its output with: 


END OF FILE 


The END OF FILE message does not appear on those dumps which use the /CH or /BL 
switch. 

2.4 DUMPING ENTIRE FILES 

Unless the /BL switch (see Chapter) is specified, FILDMP dumps the entire 
file indicated. When FILDMP encounters an end-of-file (EOF) , it prints 

END OF FILE 

closes and releases all files, and then prints # to indicate readiness for another 
command string. 

2.5 DETERMINING FILE BLOCKS, /CH 


The /CH switch is helpful in determining the block size of a program and in pin- 
pointing certain blocks of data for future referencing with other FILDMP operations 
For example: 

#KB:<DEMO/CH 
DEMO (CHAIN) 

002252 002262 

#KB;<SIZE/CH 
SIZE (CHAIN) 

001700 .001705 001712 001717 

001750 001755 001762 

002020 

# 
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DEMO is a file which is stored in the two blocks numbered 002252 and 002262. 

SIZE is a file which is stored in the 17 blocks numbered as shown. 

When using the /CH option, if FILDMP cannot find the input file, then the error 
message S206 (no input file) is printed, followed by #. (in no other case does 
FILDMP attempt to predetermine the existence of its input file, i.e., if the input 
file is not found, F012 results.) 

2.6 DUMPING BLOCKS OF DATA, /BL 

The block switch, /BL, is used to indicate the dumping of a specific block or group 
of contiguous blocks. More than one /BL switch can be specified in a command 
string. Each /BL switch requires at least one and at most two arguments (block 
numbers), and each argument is preceded by a colon. For example, the following 
command string dumps the contents of block 2252 in ASCII characters: 

#LP:/AS<DF;/BL:2252 

The following command string dumps blocks 17 through 43 in octal words; 


#LP : /0C<DT1 ; /BL : 17 : 43 


The following command string dumps blocks 15 through 21, block 32, and blocks 113 
through 121 in octal bytes; 

iLP ; /By<DK;/BL; 15 ; 21/BL ;32/BL:113;121 

The /BL switch reads input in unformatted binary only. 

The following command string dumps blocks 70 and 100 in octal and then in Radix-50. 

#LP : /OC ,.LP ; /RA<DT : /BL ; 70/BL ; 100 
2.7 DUMPING RADIX-50 FORMATTED DATA, /RA 

The /RA switch can be used to dump Radix-50 formatted data in ASCII characters. 

The /RA switch causes FILDMP to unpack the data (three ASCII characters are 
packed into one word) . 

This switch can be useful when "looking" at the data stored in Radix-50 format, 
e.g., internal directories, etc. 
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The /RA switch can be used alone or witji the /FA, /PB, or /BL switch. For example: 


#LP:/RA</BL:2:3 

FILDMP would dump blocks 2 and 3 of the DOS/BATCH system device in unpacked Radix-50 
format . 
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. PART 15 
CHAPTER 3 
SAMPLE OUTPUT 

The following example is not intended to be a practical example of the uses of 
FILDMP. Rather it is intended to show as many examples of the FILDMP options, 
output formats, and error notations as possible. 

EXAMPLE 1 


The FORTRAN source program RAD50.F4, listed below, writes 30 records of 12 words 
each containing the characters A-Z and 0-9 in packed RADIX-50 format. The output 
IS to a file named FOR001.DAT on the system device. The RADIX-50 packing procedure 
is described in Chapter 7-12. The CALL SETERR requests that the overflow into 
bit 15 (the sign bit) be ignored while the RADIX-50 characters are being packed. 


5 

niMFNSTONI INf36) 
niMFK'SlOM T0lJTfl2l 
orPTNiF FILF 1 (30, 12.U. IFRR^ 

CALI SFTERP(3»-n 

I F I F * 4 PI 

DO S J»l,26 

10 

DO 10 36 

TNf.T)»J + 3 

15 

DO 16 Js 1,1 2 

TOUT (J)*r(TNri)i*lFlF) + lN(Un)AlFlF+lNfTf2) 

20 

DO ?0 J«l,30 

WRITFCI • J) (lOUT(T) .I»l ,121 

continue 

EXAMPLE 2 

CALL EXIT 

end 


The FILDMP command string is used to get an ASCII dump of the source file RAD50.F4. 
The resulting output follows. 



«LPl/AS<RADS0.F4 


RAD50 

.F4 

(ASCIIl 

0000000 

OD 

TM 

0000020 

)9 

00 

0000040 

UT 

fl 

0000060 

FI 

LF 

0000100 

FR 

R) 

0000120 

RR 

f3 

0000140 

0000160 

0000200 

40 

00 

00 


FN 

31 

OM 

OT 

ME 

NS 

21 

00 


1 

(3 

0. 

00 

OC 



I N( 36 

10 N 

If 


00 OC 

000PI460 NO 00 

F^^n OF filf 




RD 


00 

WR 

10 

UT 

(I 

02 

00 

CO 

Al 

1 

FX 




T( 


FI 

F) 

IF 

IF 

-fl 

0 

20 

J 

IT 

ft 

1 » 

). 

!■ 

1 » 

NT 

IN 

UE 

IT 

00 

RE 


EXAMPLE 3 

The FILDMP command string shovm below is used to get a byte dump of the source file. 


The resulting output follows 


#LP*/RY<RAnS0.F4 


RAD50 

.64 

(BYTES! 

0000000 

011 

104 

111 

115 

0000020 

051 

015 

012 

011 

0000040 

125 

124 

050 

061 

0000060 

106 

111 

114 

105 

0000100 

105 

122 

122 

051 

0000120 

122 

122 

050 

063 

0000140 

064 

060 

015 

012 

0000160 

015 

012 



0000200 








05| 

015 

015 

012 

011 

103 

0000460 116 

104 

015 

012 


end of filf 


105 

116 

123 

111 

117 

Il6 

104 

111 

115 

105 

116 

123 

062 

051 

015 

012 

011 

104 

040 

061 

050 

063 

060 

054 

015 

012 

011 

103 



054 

055 










011 

104 



012 

011 

127 

122 

111 

117 

125 

124 

050 

1 i 1 

012 

062 

060 

011 

103 

117 

101 

114 

114 

040 

105 

130 


040 in 1 16 050 063 066 
111 117 116 040 
106 106 


124 050 
106 111 106 051 

111 106 ill 106 053 111 

117 040 06? 060 040 11? 

Ill 124 105 050 06.1 047 

051 054 111 075 061 054 

116 124 111 116 125 105 

111 124 015012 011 105 
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EXAMPLE 4 


The FILDMP command string shown below is used to get an octal dump of the source 
file. The resulting output follows. 


#LPi/0c<‘?ADf'P’.F4 

RADRP! .F4 (OCTAL) 

. 00OP10PI0 042P)11 (J|465U 

000ei0p0 006451 004412 

0000040 052125 030450 

0000050 044506 042514 

0000100 


047105 044523 047117 
044504 042515 051516 
024462 005015 


044440 024116 033063 

04751 1 


6 • 


005015 041411 

0000460 0421 16 005015 

FMD OF FILF 


044450 

031012 004460 047503 

046101 020114 054105 


024105 023'461 

026051 036511 026061 

052116 047111 042525 

052111 005015 042411 


EXAMPLE 5 

After the source file is compiled to an object file, RAD50.OBJ, the numbers of the 
physical blocks on the system device that contain the file are determined by use of 
the following FILDMP command: 

«LPi <PAn50.npj/CH 

RAo50 .OR.I (CHAIN) 

000352 000360 000361 000362 
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EXAMPLE 6 


To dump selected blocks of the object file in octal format (the default output 
format) the following FILDMP command is used: 


«LPt<»An50.npj/BLt35?/BL 


Dk 

000352 

(OCTAL) 







00000«0 

0000090 

0000040 

00000ft0 

0000100 

000360 

127401 

073634 

000935 

000001 

007694 

021042 

030001 

000056 

000410 

002100 

000001 

000000 

000l!)00 

050561 

021411 

055740 

076400 

000000 

000000 

00007A0 

001002 

000001 

015001 

030032 

19567e) 
001 004 
000003 

065100 

016001 

000034 

125517 

013009 

001006 

000000 

047000 

124545 

017001 

000004 

001010 

004002 

023364 

001010 

000774 

000174 

125361 

014001 

000193 

000000 

OK 

000361 

(OCTAL) 







0000000 

0000090 

0000040 

00000K0 

0000100 

00007A0 

000362 

001060 

000004 

001060 

125067 

001060 

000001 

030470 

002302 

006001 

034100 

010301 

000030 

000000 

195675 

000056 

005002 

001006 

000003 
001026 
065100 
000004 
124626 
01 1 001 

000249 
000000 
001 060 
002009 
014657 
000400 

000000 

000963 

001006 

125593 

006001 

012002 

000014 

000410 

000400 

031000 

001002 

125067 

000000 

000000 

000000 

004002 

007001 

029600 


EXAMPLE 7 

The data file containing the packed RADIX-5J2I characters, FOR0j31.DAT, may be dumped 
in unpacked RADIX“50 format by using the following FILDMP command string. The 
resulting output follows. 


#LPi/RA<FOPflpl .DAT 
FORPIPt.DAT (RAO50) 


0000000 ABC 

OFF 

CHI 

JKi 

MNP 

POP 

STU 

y 

0000090 0 

3 

6 

P 

ARC 

OFF 

GHI 

JKI 

0000040 MNP 

PQR 

STU 

y 

0 

3 

6 


0000060 ABC 

OFF 

GHi: 

JKi 

MNP 

POP 



0000100 0 

3 

(5 

p 

ABC 




0000190 MNP 

PQR 

STU 

y 





0000140 ABC 

OFF 

GH5 







000P1BP P 3 

MNP 

00PH29P 


000t7PP 

0001790 

0001740 

00017«0 
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EXAMPLE 8 


To dump the data file in octal (to see the packed RADIX-50 format) the FILDMP 
coiTimand shown below is used. The associated output follows. 

#LP«/r»C<FORW0l ,0AT 
FnRi?i0r.DAT (OCTAL) 


0000051 (?! 

003223 

014716 

02641 1 

040104 

051577 

063272 

074765 

000030 

000O0P0 

000036 

000041 

000044 

000047 

003223 

014716 

026411 

040104 

0000040 

051S77 

063272 

074765 

000030 

000036 

000041 

000044 

00004 7 

00000^0 

003P23 

014716 

026411 

040104 

051577 

063272 

074765 

000030 

0000100 

000036 

00004 1 

000044 

000047 

003223 

014716 

026411 

040104 

00001P0 

051677 

063272 

074765 

000030 

000036 

000041 



0000140 

003223 

014716 

02641 1 

040104 





00001^0 

000036 

000041 


. 





00002^0 




. 









. 



00000-3 

000000 






000000 

000000 

000000 

000000 




000000 

000000 

000000 

000000 

000000 

000000 


000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

0001700 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

00017P0 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

0001740 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

0001 7«0 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 


OF FTLF 


EXAMPLE. 9 

If the data file is mistakenly specified as being in formatted binary (the file is 
actually in unformatted binary, the FILDMP default input file format), FILDMP en- 
counters errors as it tries to read the input file. -An example of this FILDMP 
command string and the resulting output are shown below. 

#LPi<FO»'^ar.DAT/FH 
FORaai.DAT (OCTAL) 


000000 

F004 

001 

030000 

000001 

P004 

001 

000000 

000002 

F004 

001 

000000 

000003 

FI7I04 

001 

000000 

000004 

F004 

001 

000000 

000005 

F004 

001 

000000 

000006 

F034 

001 

000000 

000007 

Fa04 

001 

000000 

000010 

F004 

001 

• 

000000 

000257 

F004 

• 

• 

001 

000000 

000260 

F004 

001 

000000 

000261 

F004 

001 

000000 

000262 

F004 

001 

000000 

000263 

e-md 

F004 001 

OF FILF 

000000 
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